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Use of DANGER, WARNING, CAUTION, and NOTE 


This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out safety 
related or other important information. 


DANGER Hazards which could result in severe personal injury or death 
WARNING Hazards which could result in personal injury 

CAUTION Hazards which could result in equipment or property damage 
NOTE Alerts user to pertinent facts and conditions 


Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with 
equipment or property damage, it should be understood that operation of damaged equipment could, under certain operational 
conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully with all 
DANGER, WARNING, and CAUTION notices. 
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Chapter 1 Introduction 


1.1 General Information 


Process control applications are configured in the ABB Master Programming Language 
(AMPL). AMPL is a function-block language with graphic representation, which is especially 
developed for process control applications and consist of a Data Base (DB) part and a Process 
Control (PC) part. The language is characterized by each function being seen as a building block 
with inputs and outputs. 


In this manual the ASCII representation of AMPL is described, which is called AMPL source 
code (or simply source code). The descriptions are based on the On-line Builders point of view. 


The AMPL source code serves as a universal interface between different engineering tools on 
one hand (for example Function Chart Builder, On-line Builder) and between different 
controllers on the other hand (for example Advant Controller 410, MasterPiece 200/1). 


Various engineering tools are available to produce source code. Depending on the specific tool, 
the resulting source code is represented in different ASCII formats. For more information on 
source code transfer see Chapter 3, Source Code Transfer. 


This manual is valid for: 
° On-line Builder of version 2.4, 


° Function Chart Builder of version 4.4. 


1.2 Manual Organization 
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In Chapter 1, Introduction you find information on conventions and the terminology used as 
well as a list of related documentation. Chapter 2, Source Code Design describes the AMPL 
source code language in detail. Chapter 3, Source Code Transfer describes the differences 
between the source code representations of the different engineering tools. Four On-line Builder 
commands are presented afterwards in order to transfer AMPL source code to a controller. 
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1.3 Conventions 


Syntax 
The syntax of the AMPL source code language is described using syntax diagrams. 


The syntax of the source code handling commands is described in the form of the command 
name, followed by the arguments that are to be specified. The arguments are separated with 


symbols such as the comma “,”, slash “/”’, semicolon “;” or right angle bracket “>”. To carry out 
a command, enter the command syntax and press the Enter key. 


° Bold strings are the command names and arguments; they must be typed as they appear. 
° Italic strings represent substitutable arguments. 
° Brackets “[ ]” around an argument name indicate that the argument is optional. 


° Arguments, to be used alternatively are indicated by a vertical bar (in some syntax 
descriptions alternative choices are represented by an italic string and a separate 
explanation of its substitutions). 


1.4 Related Documentation 


1-2 


Related documents, including those referred to in this document are listed below. 
° Advant Controller 410 User’s Guide 

° Advant Controller 450 User’s Guide 

° Advant Controller 400 Series Data Base Elements Reference Manual 
° Advant Station 100 Series Engineering Station User's Guide 

° Advant Station 500 Series Operator Station User’s Guide 

° AMPL Application Building Reference Manual 

° AMPL Configuration Advant Controller 400 Series Reference Manual 
° Function Chart Builder User’s Guide 

° On-line Builder Reference Manual 

° Data Base Elements Advant Controller 400 Series Reference Manual 


° PC Elements Advant Controller 400 Series Reference Manual. 
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Chapter 2 Source Code Design 


2.1 


Introduction 


Application programs running on an Advant controller consist of two parts, one for PC 
Programs and another one for the data base. Both parts can be designed: 


° interactively while you are connected to a certain controller using the On-line Builder or 
not connected to a controller using the Function Chart Builder. 


° via Source code. 


For example, you can create a DB element interactively using the On-line Builder command 
CRDB. Guided by this command you can specify all the necessary parameters of a certain DB 
element. Afterwards you may add another DB Element or modify an existing one. 


You can get the same result when you specify at first all necessary DB Element parameters in a 
text file — the source code — and download this file then with a special translator program to the 
controller. It is obvious that the source code has to follow a certain syntax. The goal of this 
chapter is to explain the source code syntax. 


The advantage of source code is, that it is independent of the controller software version and 
that it is possible to produce source code very efficiently with tools like Function Chart Builder; 
this can be done without being connected to a controller. 


With the Function Chart Builder you design an application program graphically and store it as 
source code. Then, this source code can be downloaded with On-line Builder to a certain 
Advant Controller. In the same way you can dump an existing application from that controller 
into source code and open it with Function Chart Builder. 


You can think of source code as a kind of scripting language, that allows translator programs to 
create an application program in the dedicated environment of a certain controller. You can 
download the same source code on several controllers which are compatible with the 
application program. 


Two different kinds of source code exist: one for the data base and one for PC programs. 
You can distinguish data base source from PC source code files by the file extension: * BAX! or 
* BA for data base and *.AAX or *.AA for PC source code files. 


The syntax of source code for the data base and for PC programs differs slightly. Therefore we 
describe at first the common part and afterwards the parts that are specific for data base and for 
PC program source code. 


The whole data base is stored in one source code file. For PC programs you have to write one 
file per PC program. If you have for example ten PC programs, this will end up in ten AAX or 
AA files. 


A source code file is structured into several sections. These sections have to appear in a certain 
order. You must not change this order. Each section starts with an own keyword as an opening 


1. Three character extensions are used for files in General Representation (8-bit ANSI or ISO 88591) and two 
character extensions for text files in ABB Master Representation (7-bit ASCII) 


3BSE 003 838R0101 


2-1 


Source Code Handling User’s Guide 
Chapter 2 Source Code Design 


2-2 


clause. Very few sections have also a closing clause. Otherwise the appearance of a new 
opening clause implies that the foregoing section is closed. 


A data base source code file starts with a BEGIN DB and ends with an END DB statement, 
while a PC program source code file for PC program 3 starts with a BEGIN PC3 and ends with 
END PC3. 


The first section, that is common for both types of source code, is the HEADER section. In the 
HEADER section you can define a lot of HEADER attributes. Those attributes which will be 
used in the document’s header or footer, when you produce printouts of the database or a PC 
program. Which attributes you will see in an actual printout depends on the document template, 
you have selected. The HEADER section itself is independent on the selected template: it holds 
a superset of possible attributes. 


After the Header section the syntax is different for data base and PC program source code. In the 
case of database source code you must be able to specify data base elements are their terminals, 
while in the case of PC program source code a possibility to specify PC elements with their 
interconnections and a page layout. 


In the following a short example of a data base and a PC program source code is shown. 
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BEGIN DB 


HEADER 
IEC_Prepared 
IEC_Approved 
IEC_Project1 
IEC_DocDes1 
IEC_ItemDes1 
IEC_RespDept 
IEC_RevInd 
IEC_DocNo 
IEC_Language 


Rudolf Frohling 
Martina Walzer 
Project Name 
Test Database 
XYZ 
DEIND/AEB 
A 
3BDS000001 
en 


BEGIN GENERAL DEFAULTS 


DEFAULT DI810 
‘BUS 0 
‘STATION 
:POSITION 
‘SERVICE 


‘TYPE DI810 


INSCANT 


:FILT 8ms 
:SUP NO 


SIMPL 1 


SCANT 250MS 


DEFAULT DIS810 
‘BLOCKED 
INV 0 


0 


‘TESTED 0 


‘“ERR_CTRL 
:DESCR 
:-NORM_TR 
:AL_DELAY 
:PROC_SEC 


:CLASS 0 


:NORM_POS 
:-RP_F_CTL 
:AL_BLK 


:PR_BLK 0 
‘“ERR_TR 0 


:VALUE_TR 
‘ACT 1 


END GENERAL DEFAULTS 


DI800_1 DI810 
‘NAME DigInBoard1 


:BUS 1 
‘STATION 
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‘POSITION 
DI800_1.1 
‘-NAME 
DI800_1.2 
:NAME 
DI800_1.3 
:-NAME 
DI800_1.4 
:NAME 
DI800_1.5 
:NAME 
DI800_1.6 
:NAME 
DI800_1.7 
‘NAME 
DI800_1.8 
:-NAME 
DI800_1.9 
:NAME 
DI800_1.10 
:-NAME 
DI800_1.11 
:NAME 
DI800_1.12 
:NAME 
DI800_1.13 
‘NAME 
DI800_1.14 
:NAME 
DI800_1.15 
‘-NAME 
DI800_1.16 
:NAME 


END DB 


3 
(* DIS810 *) 
DigInputl 
(* DIS810 *) 
DigInput2 
(* DIS810 *) 
DI800_1.3 
(* DIS810 *) 
DI800_1.4 
(* DIS810 *) 
DI800_1.5 
(* DIS810 *) 
DI800_1.6 
(* DIS810 *) 
DI800_1.7 
(* DIS810 *) 
DI800_1.8 
(* DIS810 *) 
DI800_1.9 
(* DIS810 *) 
DI800_1.10 
(* DIS810 *) 
DI800_1.11 
(* DIS810 *) 
DI800_1.12 
(* DIS810 *) 
DI800_1.13 
(* DIS810 *) 
DI800_1.14 
(* DIS810 *) 
DI800_1.15 
(* DIS810 *) 
DI800_1.16 
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BEGIN PC1 


HEADER 
IEC_Prepared Rudolf Frohling 
IEC_Approved Martina Walzer 
IEC_Projectl Project Name 
IEC_DocDes! Test Database 
IEC_ItemDes1 xyz 
IEC_RespDept DEIND/AEB 
IEC_RevInd A 
IEC_DocNo 3BDS000001 
IEC_Language en 


PCD-PAGE 10 
"STRUCTURE-ELEMENT" 


PC1 PCPGM (10,1) 
:ON 1 


PC1.1 CONTRM (100,1,0) 
:ON 1 
SINGLE 0 
:R 0 
:RUN 
:MODP 


PCI.1.1 AND (2) 


il =DigInputl 
2 =DigInput2 
:20 =DigOutl 


END PC1 
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From the example source code you can recognize the very simple syntax structure of source 
code. For data base source you can see the HEADER section. Afterwards the general defaults 
section follows, which starts with the BEGIN GENERAL DEFAULTS clause and ends with the 
END GENERAL DEFAULTS clause. Behind this the section for the different DB element 
instances follows. 


The example for PC program source code looks also very simple. After the HEADER section 
the PCD-PAGE statements lets you start a new page, which may get a fix page number and a 
page title. Afterwards the PC elements of the PC program are listed. 


2.2 Common Sections 


2.2.1 Header 
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As mentioned earlier, you can define in the HEADER section a lot of HEADER attributes, 
which will be used in a document’s header or footer, when you print a source code file (for 
example using the On-line Builder command LPCD!). Each attribute corresponds to a certain 
field in the footer. 


In On-line Builder you can enter the HEADER attributes with the MDT? command. You will 
get a window which shows the footer area of the actual template. Here you can enter the text 
field by field. You will get the same window in Function Chart Builder using the Edit | 
Document Texts menu command. 


Which attributes you can enter, depends on the actual document template you have selected. 
Nevertheless, the HEADER section itself is independent on the selected template: it can hold a 
superset of possible attributes. Those, which fit to a certain template, will be shown in a 
printout. 


The sum of all HEADER attributes is referred to as Document Texts. 
Printouts can be produced for example with: 


° The On-line Builder command LDBD (List Data Base Diagram), LPCD (List PC 
Diagram) or 


7 The Function Chart Builder File | Print menu command. 


You can inspect the HEADER section when you generate source code and view it with AS100- 
Edit for example. You can generate source code with: 


° The On-line Builder command DUDBS (Dump Data Base Source), DUPCS (Dump PC 
Source) or 


. The Function Chart Builder File | Generate Source menu command. 


The HEADER section must start directly after BEGIN DB keyword in the database source code 
In PC source code it must start directly after BEGIN PC<nr>. Attributes that are not needed can 
be skipped. 


e999 


All characters except may be used for the text field in the document header: See Appendix 
A, Syntax Diagram for HEADER Section for a list of valid keywords within the header section. 


1. LPCD stands for List PC Diagram 
2. MDT stands for: Modify Document Texts 
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Example of a HEADER section: 


HEADER 


IEC_Prepared 
IEC_Approved 
IEC_ItemDes 
IEC_DocDes1 
IEC_RespDept 
IEC_DocNo 
IEC_Language 
IEC_Revind 


Rudolf Fréhling 
Martina Walzer 
XYZ 

Test Database 
DEIND/AEB 
3BDS000001 

en 

A 


Figure 2-1 shows where the HEADER attributes of the example above will show up ina 


printout. 


We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly Forbidden. 


© ABB Industrictechnik AG 


ak 2D Eb 
PAERER ABB Automation and Drives 


Projectname = Project Name 


Resp. dept. DEIND/ AEB Lang. en 
Document number 
3BDSO00001 


Figure 2-1. Location of Document Texts in a Printout 
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The following diagram explains the syntax of the HEADER statement and the attributes in the 
HEADER section: 


new (HEADER ) | 


< 


A 
Pine >| Field Name —»(SP)» Field Value 


The whole set of field names is listed in Appendix A, Syntax Diagram for HEADER Section. 


Table 2-1 shows which attributes belong to a certain template. 


Table 2-1. Allowed Header Field Names 


: ‘ Max. Length of 
Template Name Paper Size Field Name Field Value 

Standard Master A3 landscape Design_ch 25 
A4 landscape Tech_ref 25 
A4 portrait Resp_dept 25 
US Legal landscape Date 25 
US Legal portrait L_Text2 37 
US Letter landscape L_Text3 37 
US Letter portrait L_Text4 37 
R_Text1 27 

R_Text2 27 

R_Text3 27 

R_Text4 27 

Rev_Ind 3 

Language 2 

IEC 1082 A3 landscape IEC_BasedOn 15 
A4 landscape IEC_Prepared 18 
Aé4 portrait IEC_Approved 18 
US Legal landscape IEC_Title2 25 
US Legal portrait IEC_Title3 25 
US Letter landscape IEC_Project1 25 
US Letter portrait IEC_Project2 30 
IEC_Project3 30 

IEC_DocDes1 30 

IEC_DocDes2 20 

IEC_ItemDes1 20 

IEC_ItemDes2 20 

IEC_RespDept 15 

IEC_RevInd 3 

IEC_DocNo 15 

IEC_Language 2 
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Table 2-1. Allowed Header Field Names (Continued) 


Template Name 


Paper Size 


Field Name 


Max. Length of 
Field Value 


DIN 6771 


A3 landscape 
A4 landscape 


DIN_Revind1 
DIN_Revind2 
DIN_Revind3 
DIN_Revision1 
DIN_Revision2 
DIN_Revision3 
DIN_RevDate1 
DIN_RevDate2 
DIN_RevDate3 
DIN_RevNamet1 
DIN_RevName2 
DIN_RevName3 
DIN_ Date 

DIN_ Prepared 
DIN_ Checked 
DIN_Approved 
DIN_Projectt 
DIN_Project2 
DIN_Project3 
DIN_BasedOn 
DIN_ Replaces 
DIN_ReplacedBy 
DIN_RespDept 
DIN_ Title2 
DIN_Title3 

DIN_ Title4 
DIN_DocDes1 
DIN _DocDes2 
DIN_DocKind 
DIN_Language 
DIN_DocNo 
DIN_ItemDes1 
DIN_ItemDes2 


3 
3 
3 
12 
12 
12 
5 
5 
5 
4 
4 
4 
8 
10 
10 
10 
30 
30 
30 
10 
10 
10 
8 
25 
25 
25 
25 
25 
3 
2 
15 
25 
25 
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2.2.2 Comments 


You can enter your own comments in the source code file. Comments must begin and end on the 
same line but can be anywhere on the line; comments can be placed anywhere in the file. 


Comments are written in accordance with the following syntax: 


aa. string H+ ) 


Figure 2-2. Syntax for writing User Comments 


The text string may contain all of the characters which can be written. Comments may not begin 
with (*NF= or (*GD= as these are used to refer to the continuation file or the file with user- 
defined default value. 


2.2.3 Upper and Lower Case Letters 


Both upper and lower case letters can be used in the source code and mixed without causing 
translation problems. 


For PC source code the PC element and terminal names must be given in the same case sensitive 
way as defined in the controller, normally they are given in uppercase letters. 


2.2.4 New Line and Spacing 


Source code files are line oriented; this means that any element or terminal declaration has to be 
placed in a new line according to the syntax description. 


When the syntax specifies change of line, a line change must be performed. It is however 
permitted to enter blank lines in the source code without affecting its function. 


Within one and the same line, there can be any number of spaces (SP). 


Example: 
Dil DI 

:TYPE DSDI_120 
DI2 DI 


:TYPE DSDI_120 
The same functions can be written as follows (but it is more difficult to read): 
DI1 DI 
:TYPE DSDI_120 
DI2 DI 
:TYPE DSDI_120 
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2.2.5 Division of the Source Code into Several Segments 


Source code can be divided into several segments. 


The division into several segments is made by entering a reference to the continuation file in the 
source code file. This reference is placed last in the file in accordance with the following syntax: 


new _ —_.| volume segment |_| ‘ 
line > (NF= ) > name “On name >| re A 


Figure 2-3. Syntax for writing a Segment Reference 


The final declaration END DB resp. END PC<number> is only to be entered in the final file. 


The source code should only be divided between element declarations. 


NOTE 


Continuation files are not supported by the Function Chart Builder. Source code produced by 
the On-line Builder which consist of more than one file will be converted into one file by the 
Application Builders Convert utilities. 


2.3 Data Base Element Source Code 


2.3.1 
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Introduction 


This section treats the design of the data base source code. It is assumed that the reader is 
familiar with concepts and definitions described in the following manuals: 


° Data Base Elements Advant Controller 400 Series Reference Manual which contains data 
for all data base elements in Advant Controller 410/450. 


¢  AMPL Configuration Advant Controller 400 Series Reference Manual which contains 
instructions for configuration and application programming of AC 410/450. 


¢ — Advant Controller 410 resp. 450 User’s Guide. 


° On-line Builder Reference Manual which describes all On-line Builder commands. 
Command sets and working methods are described as well as command file handling 
aspects. 


The data base source code may consist of a complete database or a part of it, that is for example 
a single database instance only. 


With the On-line Builder dump command (DUDBS) and the Function Chart Builder menu 
File | Generate Source it is possible to generate source code for a complete data base. 
With additional qualifiers some parts can be explicitly selected or disabled. 


The On-line Builder load command (TRDBS) transfers database source code into the 
controller’s database; the Function Chart Builder’s Backtranslate functionality transfers it to the 
FCB’s internal data storage. 
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Declare 
START 


on A 
Declare 
HEADER 


Ne << -selected default 
values required? 
Declare 
GENERAL DEFAULTS 
ry 
Vv 
No Are explicit 


defaults 
required? 


i Yes 
Declare 


EXPLICIT DEFAULTS 


ELEMENT DECLARATION 


More 
elements 
to declare? 


Declare 
END 


Figure 2-4. Flow Diagram 


Section 2.3.1 Introduction 


Database source code in general consists of several sections (for example HEADER, 
GENERAL DEFAULTS). Figure 2-4 is a flow diagram describing the data base source code 
design, which is the sequence of sections and their contents. 


See Section 2.3.2 


See Section 2.3.3, 
Header 


See Section 2.3.4 


See Section 2.3.4.4, 
Explicit Defaults 


See Section 2.3.5 


See Section 2.3.6 


The different sections are described more in detail in the indicated chapters. 
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2.3.2 Start 


2.3.0 Header 


Data base source code always starts with a BEGIN DB statement 


new 
fine BEGIN 0B ) 


Figure 2-5. Syntax to begin Data Base Source Code 


Example: 


BEGIN DB 


Please refer to the Section 2.2.1, Header for a description of the HEADER section. 


2.3.4 Default Values 


2.3.4.1 Introduction 
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When you populate the Advant Controller’s database you create instances of a data base 
element. The element terminals are automatically allocated with default values. 


You can modify the default values during creation time interactively with the On-line Builder 
command CRDB! or subsequently with the command MDB? when the tool is connected to the 
controller. The same can be done ’off-line’ (when the tool is not connected to the controller) 
using the Function Chart Builder within the DB section window. 


In the database source code file the default values are listed in the section General Defaults 
which follows the HEADER section (see Section 2.2.1, Header). This section is surrounded by 
the opening clause BEGIN GENERAL DEFAULTS and closed by clause END GENERAL 
DEFAULTS. 


In section element declaration all instances are listed with element terminals which have values 
different from the General Default value. This reduces the size of the DB source code file. 
Figure 2-6 gives the syntax description for the section. 


1. CRDB is the abbreviation for CReate DataBase element 
2. MDB stands for Modify DataBase element 
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ee ae BEGIN GENERAL DEFAULTS be. 


Eng line (> «DEFAULT (s ) >| call name 


AA 
| new —» » element declaration 
———?} line terminal (SP > default value 


new 
> line aaa END GENERAL DEFAULTS ) 


Figure 2-6. Syntax for General Defaults 


2.3.4.2 System Defaults 


When the General Default section is omitted the database elements are created with the terminal 
values defined in the system (System Defaults); they are described in the manual Data Base 
Elements Advant Controller 400 Series Reference Manual. Nevertheless the system default 
values are included in any data base source code dump; they are not included if the switch 
/NOGD is specified for the On-line Builder dump command or the check box "Include System 
Defaults’ is not marked in the Function Chart Builder’s Generate Source Dialog. 


2.3.4.3 User defined Defaults 
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You can define your own default values (General Defaults) when handling source code. 


General Defaults need not be entered in the source code; but when Default values defined in the 
system do not suit the application concerned, you can give your own default values at the 
terminals of the data base elements while declaring them in the General Defaults section. 

All element types declared in General Defaults will receive these user defined values at the 
instance’ terminals. The terminals which are not included in the General Defaults declaration 
will be allocated with the System Default values. 


Example: 


For any reason the application requires the value 1 for terminals VALUE_TR and TESTED for 
most of DIC instances, all other terminals should receive the system default. Therefore 
VALUE_TR and TESTED get user defined default values in the GENERAL DEFAULTS 
section. 
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BEGIN GENERAL DEFAULTS 
DEFAULT DIC 
: TESTED 1 
: NORM_TR 1 


END GENERAL DEFAULTS 


DIC1 DIC 

: NAME DIC1 
DICc2 DIc 

: NAME DIC2 

: VALUE_TR 0 

: TESTED (0) 
DIC3 DIC 

: NAME DIC3 


Element instances for DIC (in the example DIC1 and DIC3) will receive the value 1 for 
VALUE_TR and TESTED. All other terminals will get the system defaults. For DIC2 the 
terminal values are explicitly changed. 


It is also possible to define your own General Defaults in a separate file and to include the 
reference to that file. The reference line must follow the syntax described in Figure 2-7 


new 2 volume |_| segment |_| a 
line > (“GD= oa name On name “¢ ) ) 


Figure 2-7. Syntax for writing a General Default Reference 


Example: 
(*GD=[volume: ]segment[|.BA]*) 


An extension for the separate file need not be given with the reference. 


The definition in the separate file follows the same syntax as if it were in the source code; 
it begins with “BEGIN GENERAL DEFAULTS?” and concludes with “END GENERAL 
DEFAULTS”. 


NOTE 


The number of user defined defaults is limited to 400. 
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2.3.4.4 Explicit Defaults 
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When the terminal values of a few elements differ from System Defaults or General Defaults, a 
temporary definition of the default values can be entered within the element instances. 
This is designated as Explicit Defaults. 


line. (> «DEFAULT (sP ) >| call name 


Syntax: 


| > new |__ element declaration 
line ( | gement Lo(se)> default value . 


Figure 2-8. Syntax for writing Explicit Defaults (opening clause) 


The default values given for the terminals apply until a new definition is made or 
“NODEFAULT” is entered into the source code. 


line. ——>{ NODEFAULT (s ) > call name -—> 


Figure 2-9. Syntax for writing Explicit Defaults (closing clause) 


Syntax: 


Outside this area the default values defined in the system respectively the default values defined 
in the General default section are valid. 


Example: 
BEGIN DB 
HEADER 
BEGIN GENERAL DEFAULTS 
END GENERAL DEFAULTS 
DIC1 DIC 
DEFAULT DIC 
:ACT 0 
DIC2 DIC 
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DIC3 DIC 
NODEFAULT DIC 
DIC4 DIC 
DIC5 DIC 
END DB 


In this example, DIC1, DIC4 and DICS will receive the system default values at the element 
terminals. The elements defined with explicit default (in the example above DIC2 and DIC3) 
will receive the value 0 at terminal ACT whose the system default value is 1. 


The Explicit Defaults declaration in the example above gives the same function as the following 
source code written without an Explicit Defaults declaration: 


DIC1 DIC 
DIC2 DIC 

:ACT 0 
DIC3 DIC 

:ACT 0 
DIC4 DIC 
DICS5 DIC 


Note the following limitation regarding the number of elements which can be given at the same 
time with Explicit Defaults: 


° One superior or independent element type 
and 
° One subordinate element type or one system element. 


If you exceed this limit only the last given Default Value will apply. 


2.3.5 Element Instances 


With data base source code you can create several instances of a DB element; within the 
instance declarations in you can specify deviations from defaults for the element terminals. 


If no terminal values are to be changed from the default values which apply, only the instance 
needs to be declared. 


It is naturally important that you follow the rules specified regarding the order in which the 
different concepts are to be defined in the date base source code. The following restrictions 
apply to the order in which different element types are to be placed in the source code. 
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Superior-subordinate: 


DAT - DS: 
DAT - MS: 
TEXT - TS: 
TTD_LOG - 
TTD_VAR: 


PIDCON and so on - 
GRPALARM - 
GRPMEMB: 


TBL_CLASS: 
TABLE: 
TBL_PARAM: 
AC450: 
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Section 2.3.5 Element Instances 


Superior elements are to be declared directly before their 
subordinate elements. 


DAT-elements should be declared before DS-element. 
DAT-elements should be declared before MS-element. 


TEXT-elements should be declared before TS-element. 


TTD_LOG is to be declared before TTD_VAR. 


Alarm-group connected elements such as PIDCON must be declared 
before GRPALARM elements, which in turn must be declared before 
GRPMEMB elements. 


The class element. 
All the table elements. 
All parameter elements. 


If the AC450 station element is present in source code it must be 
placed before any other element defining modules in the AC450 
station (for example CI535, CI520 and so on). 


The TBL_PARAM instances are sorted according to their data type in the following order: 


° String 20 

° Time Real 

° Time 

° Boolean 

° Integer Word 
° Integer Long 
° Real. 


NOTE 


Certain system elements are declared in accordance with the syntax for 
subordinate elements (Figure 2-11). 


Example: 


CAB1.1. 
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2.3.5.1 Superior, System and Independent Elements 


The syntax for superior, system and independent elements is defined as follows: 


new |_» Ss element b= 
line plement-type > number a (sp) > call name 


> v 


| new | y 4 ) p| element | = 
> line oe —>(sP)}—> value > 


Figure 2-10. Syntax Superior and Independent Elements 


The element type and the element number build up the item designation of a database instance 
(definitions, see manuals Data Base Elements Advant Controller 400 Series Reference Manual). 
This item designation is used as default name for the element. 


Example: 
DI3 refers to digital input board number 3. 


You can enter a * instead of a number which means that the element will be entered in the first 
vacant place in the data base. 


Example: 

DI1 DI 

DI2 DI 

DI3 DI 

can also be written: 
DI* DI 

DI* DI 

DI* DI 


DI1, DI2 and DI3 and their subordinate signal elements will be created with the current default 
values at the element terminals. 


Example: 


Assume that the user in the proceeding example only uses DI-boards of type DSDI_120 
(Default is DSDI_110), so the value for the TYPE terminal must be given for each instance: 


DI DI 

:TYPE DSDI_120 
DI2 DI 

:TYPE DSDI_120 
DI3 DI 


:TYPE DSDI_120 
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The terminal value can be given with terminal name or terminal number so that the example 
above can thus be written as follows: 


DI DI 

:2 DSDI_120 
DI2 DI 

:2 DSDI_120 
DI3 DI 

:2 DSDI_120 


Please notice that certain elements have the same record type but different call names (See 
manuals Data Base Elements Advant Controller 400 Series Reference Manual). 


Example: 

All AI 

AI2 AIPT 
:TYPE DSAI_145 

AI3 AITC 
:SCANT1 = 10s 

DI1 DI 

DI2 PULSE 


2.3.5.2 Subordinate Elements 


Subordinate elements are created automatically when the superior element is created. They need 
only be declared when the terminal values differ from the default values. In this case they must 
follow directly after the superior element they belong to. 


Syntax: 


new |_| |__| superior element _ channel 
line >| record type . i number A >) > number > 
ee. 


Si +O) @) ee } tS 


Figure 2-11. Syntax for Subordinate Element 
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Example: 
All AI 
AI2 AIPT 


:TYPE DSAI_145 


AI2.1 
:SCANT 10s 
:TESTED 1 
AI3 AITC 
:SCANT 10s 
DI1 DI 
DI2 PULSE 
DI2.1 
:NAME PULSE 
:SCANT = 2s 
:TESTED 1 


If * is specified for the superior element, it is even natural that an ’*’ as element number must 
follow the record type. 


Example: 
All AI 
AT® AIPT 


:TYPE DSAT_145 
AI*.1 


:SCANT 10s 
:TESTED 1 
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2.3.5.3 Table Elements 


2.3.5.4 Example 
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The correct order of the table elements is very important. 
The correct order is: 

° Class element (TBL_CLASS) 

° All the table elements (TABLE) 

° All parameter elements (TBL_PARAM). 


The content of the table data is optionally dumped within the element TBL_PARAM. The table 
values are represented there by the terminal VALUE. 


The terminal VALUE is addressed via the both terminals ROW_NO and TBL_NO. The 
terminal TBL_NO tells the system within which table the value is located. The value at the 
terminal ROW_NO tells the system which row within the table is selected. 


If a value is specified at the terminal VALUE the system uses the current values which are 
specified at the ROW_NO and TBL_NO terminals to place that value in the data base. 


The system first writes out the values for ROW_NO and TBL_NO and afterwards the VALUE. 
That process is repeated until all the data of one TBL_PARAM element are dumped. 


The short example shows one table class with its subordinates. The exchange rates for 
4 currencies (rows) of 2 different banks (tables) are given. 


The dump was created with the On-line Builder using the optional parameters /TBL and 
/OUTPUT. 


Please notice that TBL_PARAM elements are not backtranslated into the Function Chart 
Builders internal data representation although they are accepted in database source code. 
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BEGIN DB 


HEADER 


BEGIN GENERAL DEFAULTS 


DEFAULT TBL_CLASS 
‘ACT 
:NO_TBLS 
:NO_ROWS 
:NO_R 
:NO_IL 
:NO_I 
:NO_T 
:NO_TR 
:NO_B 
:NO_A20 


DEFAULT TABLE 


DEFAULT TBL_PARAM 
:TBL_NO 
:ROW_NO 


ooococorroe 


END GENERAL DEFAULTS 


TBL_CLASS1 
:NAME 
:NO_TBLS 
:NO_ROWS 
:NO_R 
:NO_A20 


TABLE1.1 
:NAME 


TABLE1.2 
:NAME 


TBL_PARAM1.1 
:NAME 
:TBL_NO 
:ROW_NO 

: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:TBL_NO 
:ROW_NO 
: VALUE 
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TBL_CLASS 
USD_Exchange_Rates 
2 


PN 


(* TABLE *) 
Bank_A 


(* TABLE *) 
Bank_B 


(* TBL_PARAM *) 
Currencies 


:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 


TBL_PARAM1.2 
:NAME 
:TBL_NO 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:TBL_NO 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 


TBL_PARAM1.3 
:NAME 
:TBL_NO 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:TBL_NO 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 
:ROW_NO 
: VALUE 


END DB 


(* TBL_PARAM *) 


Purchase_Rate 


1.750 
2 
6.970 
3 
6.500 
4 
6.780 


(* TBL_PARAM *) 


Sale_Rate 
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2.3.5.5 Modify 


An already existing data base instance can be modified if the MODIFY statement precedes the 
item designation. 


Syntax: 


new 
line ~~» MODIFY (se) item designation | »(sP) >) call name 
-—_> name 
logical |_| logical 
= file a record | 


Figure 2-12. Syntax for Modify 


a 


item designation: default name for a single database instance 
name : specifies a single data base instance. 
call name : specifies where to search for the element in the data base. If left out, 


the whole data base is searched with name as key. 


Example: 


The following example shows the way to modify the ACT terminal on DI2.3. 

Please notice: if you want to modify the terminal value of a subordinate instance the MODIFY 
statement must precede the corresponding superior instance. The MODIFY keyword preceding 
the subordinate element is rather optional. 


BEGIN DB 
HEADER 


(* Using the item designation * ) 
MODIFY DI2 DI 
MODIFY DI2.3 

:ACT 1 


(* Using the name* ) 
MODIFY DIGITAL_1 DI810 
:ACT 0 


END DB 
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2.3.6 End 


To end a data base source code use the following syntax: 


new 
line. (OM END 0B ) 


Figure 2-13. Syntax to end Data Base Source Code 


2.4 PC Program Source Code 


2.4.1 
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Introduction 


This section deals with the design of the source code for PC programs. It is assumed that the 
reader is familiar with concepts and definitions described in the following manuals: 


° AMPL Application Building Reference Manual which contains the ABB Master 
Programming Language (AMPL). 


° PC Elements Reference Manual Advant Controller 400 Series which contains data for all 
PC elements in Advant Controller 410/450. 


¢  AMPL Configuration Advant Controller 400 Series Reference Manual and which contains 
instructions for configuration and application programming of AC 410/450. 


¢ — Advant Controller 410 resp. 450 User’s Guide which describes the systems. 


° On-line Builder Reference Manual which describes all available On-line Builder 
commands. Command sets and working methods are described as well as command file 
handling aspects. 


The PC source code may consist of a complete PC program or a part of one. 


With the On-line Builder dump command (DUPCS) and the Function Chart Builder menu 
Generate Source it is possible to generate source code for a complete PC program. 


The On-line Builder allows additionally that you can create source code of: 
° a range of PC programs (for example PC1>PC5) 

° a part of a PC program starting with a control element 

° a single PC statement. 


The On-line Builder load command (TRPCS) and the Function Chart Builder’s Backtranslate 
functionality translates source code containing a complete PC program. 


The On-line Builder additionally allows to load a part of a PC program starting with a control 
element (in this case the corresponding PCPGM must exist). 


Please mention that PC source code translation to a controller is only possible if the 
controller is in configuration mode or the controller is in operation mode and the PC 
program concerned is in Build Mode. For more information see the AMPL Configuration 
Advant Controller 400 Series Reference Manual. 
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Figure 2-14 shows a flow diagram for a PC program in source code: 


Declare See Section 2.4.2 
START 
Declare 
HEADER See Section 2.4.3 
4 


No 


“New PC program 
or 


page-break?” 


Yes | 
Declare PAGINATION | 


and possible HEADING LINE See Section 2.4.4 


‘ 


ELEMENT DECLARATION See Section 2.4.5 


More 
elements 
to declare? 


No 


Declare See Section 2.4.6 


END 


Figure 2-14. Flow Diagram for writing a PC Program 


The different parts are described more in detail in the sections indicated. 
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2.4.2 Start 


2.4.3 Header 
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To begin a PC program source code use the following syntax: 
fa BEGIN ose) item designation 
ine 
;END 


Figure 2-15. Syntax to begin a PC Program 


item designation The item designation corresponds to a PC program or to elements in an 
existing program. 


;END This optional parameter defines where the first element will be inserted in 
relation to the item designation specified. 


Examples of Begin commands in the source code: 
BEGIN PC1 


BEGIN PC3.1 
BEGIN PC4.3.1.9; END 


Please see the Section 2.2.1, Headerfor a description of the HEADER section. 
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2.4.4 Pagination and Page Head Lines 


new 
line 


1 2 
—»{ PCD-PAGE } x a 


Pagination marks the beginning of a PC diagram page in accordance with the following syntax: 


i; page | i item 
r( sp) number (sp) designation 
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A 


new | | string max. | 
line a length 79 HC) 


1. Next page number, interval 1 
2. No common item designation 
3. Page-related heading line 


Figure 2-16. Syntax to begin a PC Diagram Page 
If page numbers are omitted throughout the entire source code program, the file will be divided 


into pages automatically. These pages are numbered consecutively, starting with page number | 
and continuing in increments of 1. 


During pagination you can define the part of the item designation and terminal identities which 
are common to all elements on the page. 

This leading part of the item designation need not be specified when declaring elements. 

At least one part of the item designation however must be printed. Such an incomplete item 


Tr) 


designation must begin with a “.” (point). 


The item designations and concluding identities without the common introduction must be 
declared completely. 


Example: 


Assume that page number 3 contains PC1.2.1, PC1.2.1.1, PC1.2.1.2 and PC1.2.1.3. the 
pagination can then be written: 


PCD-PAGE 3 PC1.2 

When elements are declared, the elements are given as: 
1 

11 

1.2 

1.3 


The concluding identities are abbreviated in a corresponding way. 
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2.4.5 Element Declaration 


With PC source code you can create an application program by declaring PC elements within a 
certain order. The element declaration must follow the rules shown in Figure 2-17. 


Declare 
PC element 


Instance name 


No 
p>» Declare next 
element or declare 


end. 
See Figure 2-14 


processed 


Declare 


No 
terminal >» —_— Declare next 
to be processed? element or declare 
end. 


See Figure 2-14 


Yes 


Declare element- 
terminal and any 
allocation 

of name and unit 


Figure 2-17. Element Declaration 


The element item designation, call name and call parameters (see Advant Controller 400 Series 
PC Elements Reference Manual) are first declared on one line. The input and output terminals 
of the PC element and the couplings to be made are declared on a new line for each terminal. 
Any allocation of name and unit is performed on the lines after the relevant input or output in 
accordance with the syntax diagram in Figure 2-21 and Figure 2-22. 


PC elements are entered in order of execution. 
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Example: 
ECle 

A 
Cc 

B 
d 
e 

Cc 


Figure 2-18. PC Program Structure 


For a PC program with structure in accordance with the figure above, the following are entered 
into the source code in the order given: 


PC1, A, a, b, c, B, d, e, C, f 


2.4.5.1 PC Element Declaration 
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A PC element is declared with the item designation and its element declaration (which is the call 
name and call parameters (if any)) according with the following syntax: 


new : ee 
line >| item designation —+(sP —+ callname |—»| call parameter(s) 
Figure 2-19. Declaration of a PC Element 
Example: 


PC4.1.1 AND(5) 


For structure elements like PCPGM,CONTRM and so on the place in the cycle time table is 
given as call parameter. This call parameter is optional; if it is omitted the value is determined 
automatically during translation. 


Example: 
PC1 PCPGM (40,1) 
could be written 


PC1 PCPGM (40) or 
PC1 PCPGM (40,) 


In the first case above the place in the cycle time table will allocated which is defined as call 
parameter C2. 

If many structure elements are handled, there is considerable risk that the same place number 
will be given at several elements. It is therefore preferable to omit this parameter if the place 
number is not relevant for the control function intended (second and third case above). 
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2.4.5.2 Allocation of Instance Names 


Instance names are used as alias name for instantiated PC elements; each PC element may get a 
unique name per PC program. 


When PC programming, instance names can be specified 


° with the On-line Builder using the command MNV <PCelement> (Modify Name of 
Variable) or with the directive >S in the command IS (Insert statement) 


° with the Function Chart Builder using the menu entry Edit | Names with the element 
concerned selected. 


An instance name is declared within the PC source code with the following syntax: 


new 
line ——> Instance name 


Figure 2-20. Declaration of an Instance Name 


Example: 
PC1 PCPGM (40, 1) 
INAME InstanceNameForThisItemDesignation 


Example 2: 
PC1.1.1 FUNCM 
INAME (__InstanceNameWith{}Character) 


The syntax for PC element instance names equals the one for signal names (PC terminal names 
Ne=...), see Chapter 2.4.5.4, Source Code Design. 


An instance name must be unique within one PC program and must be different from any PC 
terminal name of this PC program. 


In the following cases, the instance name must be enclosed in parenthesis: 
° If the name begins with another character than a letter (A-Z) 


° If the name contains other characters than letters, digits and the national characters like 
_—LI\{,},4,4,0,6,U,i,A... 


As the parenthesis are included in the maximum of 72 characters in the string, 
only 70 characters can be used for the variable name. 


Instance names must not equal a PC item designation, for example “PC2” 
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2.4.5.3 PC Element Terminals and their Coupling 


3BSE 003 838R0101 


PC element terminals can be coupled to 

° DB element terminals 

° Constants and operational parameters 
° other PC element terminals. 


Figure 2-21 explains the syntax of coupling input terminals of PC elements where Figure 2-22 
describes coupling of an output terminal. 


In the source code, it is only necessary to declare the PC terminals which are to be coupled. 
Other terminals are already defined through the PC element declaration. 

The terminals must be declared in numeric order. This also applies when the name of the 
terminal is given instead of its number. 


Example: 


PC1 PCPGM(40) 
:ON 
:R 
:RUN 


Can also be written 


PC1 PCPGM(40) 
| 
:2 
35 


The following restrictions apply: 

° Coupling between PC elements is always performed from the inputs. 
° There is to be one coupling only at each input. 

° An input may not be coupled to a non-coupled input. 

° Name and unit for an output are always to be allocated at the output. 


° Names of operational parameters and constants may only be allocated when a value is 
assigned. 
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Element 
terminal 


The coupling of element terminals follows in principle the same rules which apply to 
PC programming (interactive editing) in accordance with the following syntax diagrams: 


A 
Oman variable name = > 
ee | 
p>) terminalidentity [Lp 
2 
> 
~O—— 
data base 
C08) (= >) ent a 4 t : i 
(0 a=) value | [Oe SPN - > ‘hans: 
line 


1. Allocation of name/unit 


2. May not be used when an executing unit input is coupled to the data base 


Figure 2-21. Coupling of Element Inputs 


Example: 

PC1.1.2.1 TON 
I 
:TD 


PC1.1.2:5 
D=10 
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Element 
CG} terminal 


new 


line CG) 
i 
data base 
>(sP) >(0B ) ica identity 


Vv variable 
OO: 


1. Allocation of name/input 


Figure 2-22. Coupling of Element Outputs 


Example: 


PC1.1.3 STEP 


:COND  PC1.1.2.1: 
:RUN = =DO1.1, 
=D0O2.3 


You do not need to define all of the couplings in the source code. The definition of one or more 
of the element terminals can be omitted. 


Inputs which are not coupled must then be coupled when the source code has been loaded into 
the controller, otherwise the program can’t be transferred into operation mode. In a corre- 


sponding way, whole elements can be omitted and can be later entered into the system. Structure 


elements may however not be omitted from the source code if definition of their subordinate 
function elements is to be possible. 


2.4.5.4 Allocation of Variable Name 


When PC programming, variable names can be allocated 


with the On-line Builder using the command MNV <PCelement>:<terminal> (Modify 
Name of Variable) or with the directive >S in the command C (Connect) 


with the Function Chart Builder using the menu entry Edit | Names with the terminal 
concerned selected. 
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In the source code program, variable names are allocated in accordance with the syntax in 
Figure 2-21 and Figure 2-22: 


° Variable names can be allocated for uncoupled element outputs. Names are then allocated 
on the same line as the declaration of element outputs. 


Example: 


PC1.1.2.1 TON 
:TE N=TIME_DELAY 


e Variable names can be allocated also for coupled element outputs. Names are then 
allocated on the following line of the declaration of the coupling, separated by a comma. 


Example: 


PC1.1.2.1 TON 
iI PC1.1.2:5, 
N=START_DELAY 


Variable names may have a maximum of 20 characters. All characters which can be written may 
be used except “”” and “’”. 


In the following cases, the variable name must be enclosed in parenthesis: 
° If the name begins with another character than a letter (A-Z) 


° If the name contains other characters than letters, digits and the following characters: 
agli t 5 


As the parenthesis are included in the maximum of 20 characters in the string, 
only 18 characters can be used for the variable name. 


A name must be unique within one PC program and must be different from any Instance Name 
(see Chapter 2.4.5.2, Source Code Design) defined for this PC program. 


Example: 


PC1.1.2.1 TON 
I PC1.1.2:5, 
N=(#TIME$) 
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2.4.5.5 Allocation of Units 


When PC programming, units are allocated with the directive >S in the On-line Builder 
command C (Connect) resp. with the Function Chart Builder menu entry PC-Terminal | Unit. 


In the source code program units are allocated in accordance with the syntax in Figure 2-21 and 
Figure 2-22: 


° On the same line as an uncoupled element output provided variable names have not been 
allocated. 


° On the following line when units are allocated a coupled element terminal. The line which 
declares coupling to an element terminal must then be concluded with a comma. 


Example: 

PC1.1.1.2TON 
HI | PC1.1.2:5 
:TD D=10, 


U=s 


° If variable names are allocated at the same element terminal, the allocation of units is 
written on the line after the name allocation. The line with variable name must then be 
concluded with a comma. 


Example: 
PC1.1.1.2TON 
iI PC1.1.2:5 
:TD D=10, 
N=TIME, 
U=s 


2.4.6 End 


To end a PC program source code use the following syntax: 


new item — 
line [P| END > > designation |_——-»—— 
for program 


Figure 2-23. Syntax to end a PC Program 


Example: 


END PC1 
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2.5 Example 


2.5.1 Data Base Source Code 


Figure 2-24 shows a source code program for the data base. 


BEGIN DB (* Start source code *) 
HEADER (* Text header *) 
Design_ch A.Andersson 
Tech_ref B.Johansson 
Resp_dept Design dept. 
Date 1994-02-28 
Rev_ind 0 
Language E 
BEGIN GENERAL DEFAULTS (* Start GENERAL DEFAULTS *) 
DEFAULT DI 
:TYPE DSDI_120 
DEFAULT DIS 
:DESCR EXAMPLE 
END GENERAL DEFAULTS (* End GENERAL DEFAULTS *) 
DIL DI (* Create DI-element and *) 
DI1.1 (* subordinated signals *) 
:NAME SW_l 
DIL.2 
:NAME SW_2 
DI2 DI 
DEFAULT DI (* Start EXPLICIT DEFAULT *) 
:TYPE DSDL_110 
DB DI 
DI4 DI 
DIS DI 
NO DEFAULT (* End EXPLICIT DEFAULT *) 
DI6 DI 
DOI DO (* Create DO-element and *) 
DOL.1 (* subordinated signals *) 
:NAME LAMP_1 
DO1.18 
:NAME LAMP_RED 
DO2 DO 
DO3 DO 
DATI DAT(B) (* Create DAT-element *) 
:NAME B-1 (* of type boolean *) 
END DB (* End source code *) 


Figure 2-24. Example of a Data Base Source Code 
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2.5.2 PC Program Source Code 


Figure 2-25 shows a PC program written in source code. In Figure 2-26 and Figure 2-27, the 
same PC program is shown in the form of a PC diagram. 


BEGIN PCl (* Start source code *) 
HEADER (* Text header *) 
Design_ch Designer 
Tech_ref Design respo ns. 
Resp_dept Design dept. 
Date 1997-06-25 
Rev_ind 1 
Language E 
PCD-PAGE 1 (* Pagination*) 
"Source Code Sample PC1" (* Side related head] *) 
PCI PCPGM (40) (* Element declaration *) 
:ON D=1 (* Operational param *) 
:R D=0 
PC1.1 SEQ (50) 
:START =SW_1 (* Data base connection *) 
:STARTC D=0 
:R =SW_2 
PC1.1.1 STEP () 
INAME InstanceNameForStatement 
:COND D=1 
:RUN = LAMP_1,=B-1 (* Two DB- connections *) 
PC1.1.2 STEP () 
INAME(__AnotherInstanceName 2) 
:COND = B-1 :VALUE3 
:RUN = DU.2 
PC1.1.2.1 TON 
“I PC1.1.2 :RUN (* PC- connection *) 
:TD D= 10, 
U=s (* Unit *) 
:0 N=CONDITION (* Name *) 
PC1.1.2.2 OSC-B 
:EN PC1.1.2:RUN 
:TP D=0.5 
:TC D=1 
:0 =LAMP_RED 
(* NF= SRCE: PCICONTE *) (* Program continues *) 


SRCE: PCICONTE.AA 
(* This segment cont. PC1 *) 


PC1.1.3 STEP (0) 
:COND PC1.1.2.1:0, 
N=CONDITION (* Variable name *) 
:RUN =DO1.3,=B-1 : VALUE2 
PC1.1.4 STEP (0 
:COND =B-1: VALUE4 
:RUN =DO1.4 
END PC1 (* End source code *) 
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30-JUN-1997/09:25 


(* NF= SRCE: PCICONTE *) 


(* This segment cont. PC1 *) 


PC1.1.3 STEP (0) 
:COND 
:RUN 
PC1.1.4 STEP (0 
:COND 
:RUN 
END PC1 


(* Program continues *) 
SRCE: PCICONTE.AA 


PC1.1.2.1:0, 
N=CONDITION (* Variable name *) 
=DO1.3,=B-1 :VALUE2 


=B-1: VALUE4 
=DO1.4 


(* End source code *) 


Figure 2-25. Example of a PC Program Source Code 


COMMON IDENTITY: 


Pcl.l 


$EQ(50,0,0,0,0) 


=DI1.1/S3W_1l 


=DI1L.2/5wW_2 


1 START RUN 5 
D=0-2—[> STARTC MODP 6 
3 R POS 7 

END 8 


PCl.1.1/InstanceNameForStatement 


STEP(O,0,0,0,0,0,0,0 


-F1—/STEPNO RUN 5 if P— >1) 
=DAT1:6/B-1:VALUE3 1—|coNnpD | P— >2) 
PCl.1.1l/InstanceNameForStatement 
PCl.1.2/(__AnotherInstanceName__) 
STEP(0,0,0,0,0,0,0,0) | 
-F1—/STEPNO RUN 5 id P— >3) 
=DAT1:6/B-1:VALUE3 1—|conpD | a 
«1 
i 
1-PC1.1.2:RUN 1 I /--/ 0 5 >a) 
D=10s-2—/TD TE |—6 
P— >5) 
Figure 2-26. PC Diagram; Part 1 
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Pcl.1.2/(__AnotherInstanceName__} 
Pc1.1.3 


STEP (0,0,0,0,0,0,0,0) | 


Sileaa —“—MG———— ee 
1-cONDITION—————Y—Y—Y—Y——_1—_ COND | >6) 


STEP(0,0,0,0,0,0,0,0) | | 
-F1—|STEPNO RUN |-5 P-=DO1l.4 
=DAT1:7/B-1: VALUE4————1—|ConD | 


Pcl.1.4 | 


Pcl.l 


>1) =DATI1/B-1 
>2) =DOL.1/LAMP_ 1 
>3) =DI1.2/5wW_2 
>4) CONDITION-1 
>5) =DO1.18/LAMP_RED 
>6) =DAT1:5/B-1: VALUE2 
Source Code Sample PCl 


Design ch. Designer Resp. dept. Design dept 


Teoh ret Design responsible 1997-06-27 


PC DIAGRAM PC1l jie cE 
pee ind. 
jSheet =] | 


Figure 2-27. PC Diagram; Part 2 
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Chapter 3 Source Code Transfer 


3.1 Introduction 


AMPL source code can be used to copy a complete process control application (that is one or 
more PC programs and the data base, or only a data base) between: 


° Different engineering tools: 


On-line Builder 


Function Chart Builder. 


° Different target systems: 


Advant Controller 410 

Advant Controller 450 

MasterPiece 200/1 process stations 

MasterPiece 200 process stations 

Advant Station 500 Series Operator Station (a subset of data base elements only) 


MasterView 800/1 Operator Station (a subset of data base elements only). 


3.2 ASCII Formats and Character Sets 


Depending on the specific engineering tool which is used to produce source code the resulting 
source code is represented in a so called “compressed 7-bit ASCII” representation, “standard 
7-bit ASCII” representation or in a “standard 8-bit ASCII” representation. 
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Table 3-1. ASCII Formats and Character Sets 


Engineering Tool | ASCII Format Character Set pa aa 
itor 

ONB (AS 100ES) |compressed 7-bit ASCII AS 100 Edit 

FCE (AS 100ES) standard 8-bit IBM PC (OEM) | AS 100 Edit, 
DOS/Windows 
editor 

ONB (AS 500) standard 7-bit ASCII vuepad 

FCB (AS 500ES) standard 8-bit I5088591 vuepad, tcleditor 

(ISO latin1) 
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3.3 Source Code Transfer between the Engineering Tools 


The following figure shows how to exchange source code between the engineering tools: 


Convert 
ONB (AS 100ES) ~<~_ a FCB/ AS 100ES 
Copy / Transfer 
Convert 
ONB (AS 500) ~<a a FCB/ AS 500ES 


Figure 3-1. Source Code Transfer between the Engineering Tools 


For descriptions of the copy / transfer and convert utilities see the according engineering tool 
User’s Guides. 


National characters of the Swedish and the German languages are transferred via the source 
code and the copy / transfer and convert utilities. For the definition of the national characters 
concerned see Advant Station 100 Series Engineering Station User’s Guide. 


3.4 Naming of Source Code Files 
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In general the volume and segment (file) definitions stated in On-line Builder Reference Manual 
apply. In addition the following restrictions take place: 


Data Base Source Code 
° Compressed ASCII format: 

The extension contains only following two characters “BA”. 
° Standard ASCII format: 

The extension contains following three characters “BAX”. 


The segment name starts with maximum six characters, which are given by the user. 
The remaining last two characters are used for automatic segment numbering. 


Example for a compressed ASCII data base source code segment: 
NAMEO01.BA 


For definitions regarding a separate General Defaults file see Section 2.3.4, Default Values. 
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PC Source Code 


Compressed ASCII format: 
The extension contains only following two characters “AA”. 
Standard ASCII format: 


The extension contains following three characters “AAX”’. 


The segment name starts with maximum four characters, which are given by the user. 
The following two characters mirrors the PC program number (01...99). The remaining last two 
characters are used for automatic segment numbering. 


Example for a standard ASCII PC source code file (PC7, first file): 
NAME0701.AAX 


3.5 On-line Builder Source Code Transfer Commands 
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The following commands are available to work with source code: 


TRDBS (TRanslate Data Base Source). This command translates and loads the data base 
source code into the target system. 


TRPCS (TRanslate PC Source). This command translates and loads the PC source code 
(one or more PC programs) into the target system. 


DUDBS (DUmp Data Base Source). This command dumps the data base source code. 
DUPCS (DUmp PC Source). This command dumps the PC source code (one or more 
PC programs). 


NOTE 


The source code dumps contain all important data of the control application, but 
not the Type Circuit concerning files *.TC, *.TB and *.TI of Function Chart 
Builder. 
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3.5.1 Loading Source Code 


3.5.1.1 General 


When loading source code in a controller start with the data base part and then continue with the 
PC part. 


Before the source code is loaded the following should be checked: 


Data Base 


The data base is to be dimensioned which is performed with the command DIMDB 
(described in the manuals AMPL Configuration Advant Controller 400 Series Reference 
Manual, MasterPiece 200/1 Configuration and Programming). The dimensioning must 
correspond to the data base to be loaded. (The Function Chart Builder adds a section 
containing the dimensioning figures at the end of the source code and generates a 
commandfile which can be used in On-line Builder for dimensioning purposes.) 


It is possible to load a complete data base or to supplement an existing data base. In the 
latter case the elements to be loaded must not exist in the existing data base. Before the 
loading is performed, these must be removed with the command DDB, (described in the 
manuals AMPL Configuration Advant Controller 400 Series Reference Manual, 
MasterPiece 200/1 Configuration and Programming). Otherwise an error message is 
obtained and the existing element is not updated. The translation continues however with 
the next element. 


PC Program 


3-4 


The PC part must be dimensioned in correspondence with the source code to be loaded. 
The command DIMPC is described in the manuals AMPL Configuration Advant 
Controller 400 Series Reference Manual, MasterPiece 200/1 Configuration and 
Programming. 


Expansion of the PC program tables is obtained automatically in MasterPiece 200/1. 

For MasterPiece 2X0, the user may obtain an error printout indicating that some of its 
tables are full. The commands CSPT and INCPT are used in MasterPiece 2X0 to expand 
the program tables in MasterPiece 2X0 (see MasterPiece 200/I Technical Description). 


PC programs with the same PC program number as those to be loaded may not exist in the 
control system. If the source code program is to replace the existing, this is to be removed 
with the command DS (described in the manuals AMPL Configuration Advant Controller 
400 Series Reference Manual, MasterPiece 200/1 Configuration and Programming). 


Call parameter C2 in some structure elements specifies the position in the cycle time table 
and may not be the same for several elements. The simplest way to avoid this is never to 
give this parameter in the source code if the control function does not require the 
parameter to have a certain value. The system will introduce this number automatically 
when loading. 
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USER Volume 


° If data base and PC source code are loaded completely in an empty system, a new target 
system directory has to be created to get an original USER volume. Or the USER volume 
has to be put in the original state (described in the manuals AMPL Configuration Advant 
Controller 400 Series Reference Manual and MasterPiece 200/1 Configuration and 
Programming). 


° If an earlier source code dump is to be loaded into a system which is not empty, it is 
important that the USER volume belonging to the system is used for the loading. 
This USER volume is also to be used at removal of the old PC program or the old data base 
element which is to be replaced by the source code program which is to be loaded. There is 
to be no information on the USER volume which is coupled to the elements to be loaded. 
The command DS causes automatic disappearance of this information. The information 
defined by the user in the source code with respect to variable name pagination, document 
texts and so on will be translated to the USER volume at loading. 


3.5.1.2 Loading the Data Base 


3BSE 003 838R0101 


TRDBS 


The TRDBS (TRanslate Data Base Source) command translates a data base source code file 
(segment) to object code and loads the latter into the target system. The data base source code 
must have a syntax according to Chapter 2, Source Code Design. 


Syntax: 


TRDBS [volume[:segment[;option[,noferr][, IEB][,1V]]]] 


volume 


If this parameter is omitted, the command changes over to DIALOG mode. A specified name 
does not update the used default volume. 


segment 


Specify the segment name (8 characters) without extension. If this parameter is omitted, 
the command changes over to DIALOG mode. 


option 
This parameter specifies the error reporting mode. The following choices are available: 


S: SHORT MODE. A separate error file with the extension BE is created if any errors occur. 
This is the default mode. 


SP: SHORT MODE PRINTER. A separate error list is output to the printer if any errors occur. 


L: LONG MODE. Error comments are inserted in the data base source code file if any errors 
occur. 


LP: LONG MODE PRINTER. A data base source code list with inserted error comments is 
output to the printer if any errors occur. 
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noferr 


The parameter specifies the permitted number of errors before the command will be interrupted. 
The default value is 32767. 


IEB 


This keyword specifies command interruption if a data base element cannot be created in the 
connected control system. 


IV 


This keyword specifies that the volume names within the Source Code are not checked, but the 
segment names only are used (see Section 2.2.5, Division of the Source Code into Several 
Segments). All available volumes will be searched to find the given segment. 


NOTE 


° TRDBS is an interactive command and will prompt the user for all required input, 
including the initial parameters (if omitted). 


° The source code can be dumped by the command: DUDBS - DUmp Data Base Source, or 
it can be created with a text editor. 


° If both volume and segment names are specified, but no options, default options are used, 
that is short mode and error file on disk. 


° The command will update symbols indicating how the command performed. 
These symbols are: 


MA$STATUS_CMD : Name of command, that is TRDBS. 


MA$STATUS_CODE : Error code, where zero (0) indicates success and one (1) that break 
was input. Other values indicate first error. 


MA$STATUS_TEXT : Text describing the error first encountered (If any). 


The symbols can be tested for example in command files. 


Examples 
Example |: 


Translate source code file in short mode with error file on disk. 
#TRDBS SRCE:DBO01 


or 
#TRDBS SRCE:DB01;S 


Example 2: 


Translate source code file in long mode with error file on printer. Break after 12 errors. 
#TRDBS SRCE:DB02;LP,12 
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Example 3: 


Translate source code file in short mode with error file on printer. Break if any insertion fails. 
#TRDBS SRCE:DB03;SP,IEB 


Example 4: 
Translate source code file in long mode and ignore the volume names within source code file. 


Break after 12 errors. 
#TRDBS SRCE:DB02;L,12,IV 


3.5.1.3 Loading a PC Program 
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TRPCS 


The TRPCS (TRanslate PC Source) command translates a PC source code file (segment) to 
object code and loads the latter into the connected control system. The PC source code file must 
have AA as extension and must have a syntax according to Chapter 2, Source Code Design. 


Syntax: 


TRPCS [volume[:segment{;option[,noferr][,ISB][,1V]]]] 


Description: 


volume 


volume name, 4 characters, default is SRCE 


segment 


segment name, max. 8 characters. The command changes to DIALOG mode, if no segment is 
specified. 


option 
This parameter specifies the error reporting mode. The following alternatives are available: 


S: SHORT MODE. A separate error file with the extension AE is created if any errors occur. 
This is the default mode. 


SP: SHORT MODE PRINTER. A separate error list is output to the printer if any errors occur. 
L: LONG MODE. Error comments are inserted in the PC source code file if any errors occur. 


LP: LONG MODE PRINTER. A PC source code list with inserted error comments is output to 
the printer if any errors occur. 


In the dialog path there are additional value alternatives. 


noferr 


The parameter specifies the permitted number of errors before the command will be interrupted. 
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ISB 


This keyword specifies command interruption if a PC element cannot be inserted in the target 
system. 


IV 


This keyword specifies that the volume names within the Source Code are not checked, but the 
segment names only are used (see Section 2.2.5, Division of the Source Code into Several 
Segments). The segments will be searched on all volumes available. 


NOTE 


° TRPCS prompts for each source code segment found on specified volume, if only the 
volume is given as argument. It is possible to select one or more segments to be translated. 


° The command will update symbols indicating how the command performed. 
These symbols are: 


MA$STATUS_CMD : Name of the command, that is TRPCS. 


MA$STATUS_CODE : Error code, where zero (0) indicates success and one (1) that break 
was input. Other values indicate first error. 


MAS$STATUS_TEXT : Text describing the error first encountered (If any). These symbols 
can be tested for example in command files. 


Examples: 
Example 1: 


Translate source code. 
#TRPCS SRCE:DUMP0101 


Example 2: 


Translate source code in long mode, interrupt after the tenth error and interrupt if a PC element 
can not be inserted. 
#TRPCS SRCE:DUMP0101;L,10,ISB 


3.5.1.4 Incorrect Translation 
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If many errors are detected when a source code program is loaded, it is most suitable to correct 
the source code with the editor and then perform a new loading. 


If the source code contains only a few errors, it can be more suitable to utilize the parts which 
have been successfully translated and supplement the application program with the commands 
CRDB, MDB and IS and C respectively. 


The errors which have been made in the translation are simple to find with the editor search 
functions. The error texts are located as comments in the error message file and are introduced 
with (*IS>>>>, (*C>>> and (*TRPCS>>> and (*GD1>>>, ((DB1>>>, (*DB 2>>>, (*--1>>> 
and (*--2>>>. 
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If IEB and/or ISB are specified when loading source code, the translation is interrupted as soon 
as an element cannot be created. When transferring data base source code, all elements up to the 
error point are created if the source code is in “PASS2, Inserting position independent 
elements”. In a corresponding way, all elements forward to the error point have been created in 
the PC program. The user must therefore remember to remove the elements created before the 
corrected source code can be reloaded. In addition, this applies always if a source code loading 
is interrupted for some reason. If this is not done, “INSERTION FAILURE” is obtained with the 
renewed loading. 


Expansion of the PC program tables is obtained automatically in Advant Controller 400 Series 
and in MasterPiece 200/1. In MasterPiece 2X0 equipment, an error printout is issued when any 
of these tables is full. The commands CSPT and INCPT may then be used to expand the 
program tables (see MasterPiece 200 User’s Guide). 


The symbol table on the USER volume is used for storage of variable names, document texts 
and heading lines. If this table is filled, it can be expanded with the command MSTABS 
(Modify Symbol TABle Size). 


If the commands TRDBS and TRPCS are used in a command file, the following symbols can 
be used to improve the error handling: 


MA$STATUS_CMD 


Captures the name of the failing command. The value of this symbol is provided by the TRDBS 
and TRPCS commands. 


MA$STATUS_CODE 


Error code: 0 indicates success, | indicates user-terminated translation and all other values 
represent the error code of the first encountered error. The value of this symbol is provided by 
the TRDBS and TRPCS commands. 


MAS$STATUS_TEXT 


Description of the first encountered error. The value of this symbol is provided by the TRDBS 
and TRPCS commands. 


Example of TRPCS in a command file with enhanced error handling: 

TRPCS SRCE:DUMP0101 

IF MA$STATUS_CODE .EQ. 0 THEN GOTO ok 

IF MA$STATUS_CODE .EQ. 1 THEN TYPE “! BREAK Pressed!” 

IF MA$STATUS_CODE .NE. 1 THEN TYPE “‘ ‘MA$STATUS_TEXT’ “ 
ok: 

EXIT 
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Figure 3-2 shows an error printout of data base source code. 


BEGIN DB 


HEADER 
Design_ch 
Tech_ref 
Resp_dept 
Date 
Rev_ind 
Language 


A.Andersson 
B.Johansson 
Design dept 
1994-02-28 


0 
English 


(* DB 1>>>VALUE STRING TOO LONG *) 


BEGIN GENERAL DEFAULTS 
DEFAULT 


(* GD 1>>>UNDEFINED VALUE *) 
DEFAULT 


DI 
‘TYPE 


DIS 


:DESCR 


:BUG 


(* Start source code *) 


(* Text header *) 


(* Start GENERAL DEFAULTS *) 


DSDI_150 


EXAMPLE 
0 


(* GD 1>>>ILLEGAL TERMINAL IDENTITY, IT DOES NOT EXIST *) 


DEFAULT 


AIS 
:NAME 


LEVEL 


(* GD 1>>>DEFAULT NOT ALLOWED FOR THIS TERMINAL 


END GENERAL DEFAULTS 


DIl 
DIL.1 


DI2 


DOI 


DO1.1 


DO1.18 


DATI 


END DB 


DI 


:NAME 


:NAME 


DO 


:NAME 


:NAME 


DAT(B) 
:NAME 


(* End GENERAL DEFAULTS *) 


(* Create DI-element and *) 
(* subordinated signals *) 


Sw_l 
Sw_2 
(* Create DO-element and *) 
(* subordinated signals *) 
LAMP_1 
LAMP_RED 
(* Create DAT-element *) 
B-1 (* of type boolean *) 


(* End source code *) 


Figure 3-2. Example of Error Printout when loading Data Base Source Code in Long Mode 
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Figure 3-3 shows an error printout of a PC program source code. 


BEGIN PC1 (* Start source code *) 
Date 1994-02-28 

(* TRPCS>>>WARNING. “HEADER” LINE MISSING *) 

Rev_ind 0 

Language English 

(*TRPCS>>>MAXIMUM LENGTH FOR TEXT IN LINE EXCEEDED*) 

PCDPAGE 1 1 (* Pagination *) 


(* TRPCS>>>SYNTAX ERROR. UNEXPECTED TEXT IN SOURCE LINE *) 


PCl PCGM (40) (* Element declaration *) 
:ON D=0 (* Operational parameters *) 
:R D=0 
PC1.1 SEQ (50) 
:START =SW_1, (*Data base connection *) 
(* C>>>CONNECTION PERFORMED BUT NAME OR UNIT CANNOT EXIST HERE *) 
N= START 
(* C>>> SYNTAX ERROR. UNEXPECTED TEXT IN SOURCE LINE *) 
:STARTC D=0 
:R SW_2 
PC1.1.1 STEP() 
:COND D=1 
:RUN LAMP_1,=B-1 (* Two DB- connections *) 


(* C>>> SYNTAX ERROR. UNEXPECTED TEXT IN SOURCE LINE *) 


PC1.1.2. STEP() 
:COND =B-1: VALUE3 
:RUN =DI.2 
PC1.1.2.1 TON 
af PC1.1.2:RUN (* PC- connection *) 
:TD D=10, 
Us=s 
PC1.1.2.2 OSC-B 
INAME InstanceNameFor thi sPCstatment 
:EN PC1.1.2:RUN 
:TP D=0.5 
:TC D=1 
:0 =LAMP_RED 
(* NF= VOL1: PCICONTE *) (* Program continues *) 
(* This segment continues PC1 *) 
PC1.1.3 STEP (0) 
INAME InstanceNameFor thi sPCstatment 
(* A duplicate INAME defin ition would cau se would cause a syntax error *) 
:COND PC 1.1.2.1:0 
N= CONDITION 
:RUN =DO1.3, =B-1: VALUE2 
PC1.1.4 STEP (0) 
:COND =B-1: VALUE4 
:RUN =DO1.4 
END PC1 (* End source code *) 


Figure 3-3. Example of Error Printout when loading PC Source Code in Long Mode 
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3.5.2 Dumping Source Code 


3.5.2.1 General 


The following should be checked before the source code is translated from object code to source 
code which is to be stored on a volume, that is the volume SRCE: 


3.5.2.2 Dumping the Data Base 


If user-defined default values are to apply for the element connections when dumping, 

the General Defaults declaration must be placed in a file with the nnme DBGENDEF.BA which 
is to be available when dumping. It is important that the same General Defaults are used when 
the source code dumped is subsequently loaded. The data base will otherwise receive an 
incorrect content at loading. 


DUDBS 


The DUDBS (DUmp Data Base Source) command dumps data base source code from the 
system into a segment or to a printer. The segment name must be defined, having not more than 
six characters. The extension of the segment is automatically “BA”. The first segment of a 
dumped source code gets the sequence number 01 automatically. If the source code is dumped 
to more than one segment, the following segments get consecutive sequence numbers. 


The command switches to an interactive mode, if necessary arguments are missing. 
Syntax: 

DUDBS [volume:][segment][,SEL=selection|[Opt_param|] 

Description: 

The argument “selection” specifies the elements to dump: 

° All data base elements in every category, (SEL=ALL). 

° All data base elements of one type, (for example SEL=DIC). 

° All data base elements in a range of types (for example SEL=AI*) 

° A range of elements of the same type, (for example SEL=AI1>4). 

° One specific data base element, (for example SEL=AIC6). 

° One specific data base element referenced by its name, (for example SEL=X YZ). 


° A range of elements of the same type via their logical file/logical record number, 
(for example SEL=334.1>5). 


° One specific data base element via its logical file/logical record number 
(for example SEL=334.1). 


° The first element in the range must exist (in Example 3 below in this chapter, DIC] must 
exist). 
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NOTE 


e A single subordinate element cannot be dumped for example if you wish to 
dump AJ3.4, the elements AJ3 and all its related subordinate elements 
AJI3.1 - AI3.16 must also be dumped. 


e “ALL” is a reserved word. If the user has an element with the name ALL and 
specifies this when dumping, it will be interpreted as the directive ALL and all 
of the data base elements will be dumped. It is however possible to use the 
data base index to dump an element with the name ALL (see the manuals 
Data Base Elements Advant Controller 400 Series Reference Manual and 
MasterPiece 200/1 Data Base Elements. 


Optional Parameters 


If no “Opt_param”’ is specified, the general defaults are dumped ONCE for each element type 
and then for each element ONLY the input values differing from the defaults. 


The argument “Opt_param” is as follows (single, or in combination): 


/NOGD 


The General Defaults are suppressed when using this optional parameter. This can be 
advantageous if a separate General Defaults segment is used (for example to have common 
General Defaults valid for more than one node). 


/FULL 


The element connections which are the same as the default values are also listed, but no General 
Defaults. 


/MODIFY 


This parameter provides modify statements according to Section 2.3.5, Element Instances 
instead of the normal create statements. 


=maxsize 


Use this parameter to specify the maximum permissible size of a segment when dumping. When 
a segment is full, a new file is opened in which the continuation of the source code is stored. 
The division of the source code into several segments is thus performed automatically. If no size 
is specified, a size 20-40 blocks is obtained. Permissible values are 1-100 blocks. 


/OUTPUT 
/OUTPUTS 


The values of outputs are also included in the dump. The outputs are /OUTPUTS 
dumped as comments in the source code to avoid problems in later loading. 
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3L 
The user can select listing of the source code on a printer instead of ”,” or in parallel with 
storage on a volume. This is done with the parameter L. 


/TBL 


The values of TBL_PARAM elements are included in source code dump according to Section 
2.3.5, Element Instances. 


/NOSYS 


The system elements are not included in the dump when using this optional parameter. This can 
be useful to minimize the size of the resulting output files. 


Examples 
Example |: 


Dump all DI Calculated elements to disk only: 
#DUDBS SRCE:DABASE,SEL=DIC 


Example 2: 


Print the data base source code for all data base elements, omitting the leading default values 
section and the system elements of the listing: 
#DUDBS ,SEL=ALL/NOGD/NOSYS;L 


Example 3: 


Dump the input and output values from the first three elements of type DI Calculated and print 
the source code: 
#DUDBS SRCE:DABASE,SEL=DIC1>3/OUTPUT;L 


Example 4: 


Dump the first element of DI Calculated with a “MODIFY” keyword preceding the element 
name: 


#DUDBS SRCE:DABASE,SEL=DIC1/MODIFY 
Example 5: 


Dumping of an element with NAME = MOTOR 
#DUDBS SRCE:DBDUMP,SEL=MOTOR 
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3.5.2.3 Dumping a PC Program 
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DUPCS 


The DUPCS (DUmp PC Source) command dumps a PC program source code from the system 
into a segment or to a printer. 


Syntax: 


DUPCS item_des 
DUPCS item_des 
DUPCS item_des 
DUPCS item_des 


>item_des]/[volume:|segment[=size][;[L][D]] 
snumb_elements]/[volume: |segment[=size][;[L][D]] 
>item_des];L[D] 

snumb_elements|;L[D] 


ao 


Description: 
L The source code dump is destined to the printer. 
D All PC scan table position parameters are omitted in the dump. 


The segment name must be defined, having not more than four characters. The extension of the 
segment is automatically “AA”. The first segment of a dumped source code gets the sequence 
number 01 automatically. If the source code is dumped to more than one segment, the following 
segments get consecutive sequence numbers. If there is an existing segment with the same 
segment name containing a PC program with the same number, no dump is performed and an 
error message is presented on the display screen. 


If no volume and segment names are given, but an L parameter, the dump is listed on the printer 
only. 


If the command is given without the parameter “size”, the size is 40 blocks. If no volume name 
is given, the default volume name is SRCE. 


If the command is specified with a structure element, this will be dumped together with all 
elements in subsidiary structures. The same applies to the second item designation if the 
command is given with two item designations and the second is a structure element. 


Example: 
#DUPCS PC1.1>PC2.5;LD 


The item designations used to specify the interval to be dumped can be stored in different PC 
programs. If the interval contains nonexistent PC programs, no segment is created for these. 


The interval can also be given with a item designation followed by the number of elements to be 
dumped. The item designation then marks the first element to be included in the dump. 


Example: 


75 PC elements are to be dumped. The dump begins with PC1.1. 
#DUPCS PC1.1;75;L 


If the source code is to be dumped on a segment, the separator “/” is given followed by optional 
volume and segment names. 


Example: 


#DUPCS PC1/SRCE:AAAA 
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Appendix A Syntax Diagram for HEADER Section 


Figure A-1. Header keywords 


new |__( HEADER) x 


> fine —»{ Design ch )-»(SP)—» eiingimen. 

4 

. ae 
of ney |-»(Tech_ret_)-»(6P)| sting ge 

4 

fe i i‘(asw’”é‘(i‘i al 
‘> line (> Resp_dept >(SP) > string max. 

4 

i ee, 
> line (Date )-»(P)> string max. 

4 

fe oS 
> livies t—> L_text 2 >(SP) > jain max. 

4 

: ee’ 
> line t—> L_text 3 >(sP)-| aan max. 

4 

7 ——— 
P| line | > L_text 4 >(SP)> pain max. 

4 

®: >: 
> line [—> R_text 1 >(sP)-| jan max. 

4 

4 ae 
> line [—> R_text 2 >(sP)->| rade max. 

4 

‘ eee « 
P| line | >( R_text 3 >(SP)> pain max. 

4 

J Ses ee 
> fine > R_text 4 >(SP)> ai max. 

4 

: a 
“of Ra’ | »(Rev_ind _)-»(6P)»| siting max 

4 

> =. x > 
> fine (Language )>(SP)> string max. 
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new 
line 


string max. 


length 15 


ys 


> 
_—_»( IEC_BasedOn >(sP) >| 
<4 


LS 


> 
L_»| line. 4 |EC_Prepared)—»( Sp) —» ang max. 
~_q- 
2 rN 
>| fire. -—»( IEC_Approved >(sP) >| string max. | 
~_- 
L if Jt 
> line -—>|_ IEC_Title1 (sP)> eng max. 
ag 
on A 
—p new _yf IEC Title2 >(sP)> string max 
<« 
< rX 
: 7 
L_p| line IEC_Title3 >(sP)—>| ae max 
~- 
i“ A 
> Tine IEC_Project1 >(sP)—>| ae max. 
~<a 
. A 
— line (> IEC_Project2 >(sP) >| pining mare 
~<_- 
: Tt 
ai line. -—>\ IEC_Project3 >(sP) > aang mex: 
<q 
ay 
—p» new | _»( IEC _DocDest >(sP) >| fing ma. 
4 
> 
faaqemen | 
> fine, > IEC_DocDes2 >(sP) > string max 
4 
s Tt 
tine "string max. 
—p} new IEC_ItemDes1 >(sP) string ma 
4- 
ca ft 
>) Tine IEC_RespDept >(sP)—>| ane max. 
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, > 


ie new Peeanaene. | 

ss es oe 
<« 
aod 

—> line IEC_DocNo *(sP)—+ string max. 
~q- 
Sd 

Line! |» VEC _Lanausag—o(sp)—of ange 
~_- 
je 

—p new _» DIN Revindt >(SP)—> string max 
a 
a 

—») rew | _y DIN Revind2 string max 


~4- 
> 
nail [string max. | 
L_p| new DIN_Revind3 length 3 
~<_- 
+ 
nani = | string max. | 
—P) line | DIN_Revision1 length 12 
~<a 
a 
aa on | string max. | 
—» new |_»/DIN_Revision2 length 12 
I 
_ 


—p new |_»/DIN_Revision3 string max 
~. 
> 
Ine. | string max. | 
> tine [> DIN_RevDate1 ating 
4 
> 
line | string max. | 
>| line [> DIN_RevDate2 attlog thax 
4 
> — 


>| ie’ —>{DIN_RevDate3 string max. 


a 


Ly 


| Legh ea Ly 


ie ee 


> 


> 
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new 
line 


a 
<_<? 


string max. 


length 4 


tT 
: ft 
> line, DIN_RevName >(SP)—» arin max. 
~q- 
x ey 
Lyi new |_| anal 
BE (Om ened seo! Bie 
~q- 
> 
L_ »j) new | = 7 
> line DIN_ Date >(SP)> Rat Tha 


— 


new 
line 


= 
DIN_ Prepared >(sP)—| 
<a 


length 10 


Ly 


new 
line 


length 10 


a 
—»( DIN_Checked >(sP) > 
~<eg- 


new 
line 


>_> 
DIN_Approved >(sP)—| 
« 


_length 10 | 


new 
line 


> 
—»(DIN_Projectt >(sP) > 
<q 


| length 30__| 


gl) ctl 


7 a 


new 
line 


DIN_Project2 >(sP) 


| length 30 


Ly 


~<a 


¥ 


new 
line 


DIN_Project3 >(sP)— 


4 


| length 30 


> 


new 
line 


> 
DIN_BasedOn >(sP)—| 


[length 10 | 


> 


4 


new 
line 


a 
-—>\ DIN_ Replaces >(sP) >| 
4 


length 10 


new 
line 


pe 
IN. ReplaceaBy) 
—ADIN_Repiaced By}m(sP)—> 


length 10 
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> 
A 
a -— string max. 
<<. 
eae 
> Tine | ->( DIN_Title2 (sP) pl string max. 
<a 
: mi 
Ly} new |_| ; 7 
> nev DIN_Title3 >(sP)—> string max 
= 
> 


A 
“>| tine | >( DIN_Titlea — ) (sp) length 25 _ 
<a 
> 


A 
—P Tine | > DIN_Free >(sP)—| iongthas. ee 
~<a 
| if Tt 
| new |_»(DIN_DocDes1 >(sP)—>| re 
~<a 
, e ia 
—> fe |-->{DIN_DocDes2)—>(SP)—» siting max 
—~—« 


a A 
L_p| new DIN_Dockind >(sP)— cna Re 
~<4 
> A 
Lp new DIN_Language >(sP) nae 
+4 
~ x 
> ee DIN_DocNo >(sP)—>| tength 15” 
! « 
> ti‘i‘i 
tri . 
>| new |->{DIN_temDest)>(SP)—>) siting me 


+4 
> 
Ly! new —» —_>| >) string max. 
line DIN_ItemDes1 length 25 
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a 
A 
tri : 
ss 
— 


“> Tne —e{ USR_Free2}->(SP)—™ egs™ a 
~_q- 
> 
L_p| new i—»( USR Free3 >| string max. noe 
line _rree length 15 
<j 
: ft 
new |_y{ USR_Freed >(sP)> string max. 


= 
> 
new Fann waa 

—> tine [> USR Frees )»(SP)—> ra a __| 

~@- 

: Tt 
> ine USR_Free6 >(sP)—| string max. 

~<- 

‘ mi 
P| fine. |» USR_Free7 >(sP) >| ae _ 

~< 

i 


L, 


—> line. > USR_Free8 >(sP) > rage} Were 
~<a 
as z 
—p new | yf USR Freeg >(sP)—>| aning max 2 
ue = length 15 
~<a 


> 
P| line >(USR Freet 0) (SP) >| ating max. | 
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